home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 24 / Mac Magazin and MacEasy Magazine CD - Issue 24.iso / Wissenschaft & Technik / O Boy folder / Read Me < prev   
Text File  |  1996-07-06  |  9KB  |  243 lines

  1. O Boy 1.0 
  2. June 1996
  3.  
  4. This file contains lots of information about O Boy.  Some of this information can
  5. be found in the 'about dialog' of the application, some cannot.
  6.  
  7.  
  8.  
  9. Who
  10.  
  11. - O Boy was developed by Bob Boylan
  12.   and I dedicate it to my wife, Terry, for her
  13.   love and her understanding of my ways.
  14.  
  15.  
  16. - Credits
  17.  Jens Peter Alfke - thanks for the AEGizmos ...
  18.                     I couldn't live without them.
  19.  Constantine Spathis (MadHack) - thanks for the shell,
  20.                                  the good times, and MacHack info.
  21.  Kevin Koestner - thanks for testing and for your opinion.
  22.  Jacquelyn  - thanks for helping design the icon.
  23.  Katelyn    - thanks for the keyboard help.
  24.  James/Davey - thanks for loaning me your Game Boy.
  25.  
  26.  Steve Jasik (Clapton of the Mac) - God I love that debugger.
  27.  Bare Bones - thanks for the jewel of my development environment.
  28.  Metrowerks - thanks for the quality we all need more of.
  29.  Onyx - thanks for the feeling that everything is OK.
  30.  Monarch - thanks for loaning me the Mac IIfx I used to develop O Boy.
  31.  MacHack 96 - thanks for the challenge and, in advance, for a great time.
  32.  
  33.  
  34.  
  35. What
  36.  
  37. -    O Boy is a tool for developers.
  38.     It allows you to walk the hierarchy of objects on your
  39.     Macintosh using familiar boy-ish controls.  O Boy shows
  40.     the properties and the sub-models of any object.  In
  41.     short, it shows you everything.
  42.   
  43.   
  44. -    O Boy is a Hack, A MacHack that is.
  45.     It is an entry in the 1996 MacHack contest - my first
  46.     entry in any programming contest so please excuse my
  47.     ramblings if they are improper.  If you have any
  48.     suggestions and/or comments about this Hack then please
  49.     drop me a line ... see the 'where'.
  50.   
  51.  
  52. -    O Boy is (yet another) example of why the MacOS is great.
  53.     (I can't believe I just said that).  Kidding aside, O Boy
  54.     exploits a Mac only technology (AEOM) that is beginning to
  55.     reach it's potential.  Maybe O Boy will help that cause.
  56.     
  57.     
  58. When
  59.  
  60. - Was O Boy Developed?
  61.   O Boy development began on Tax Day 1996 (April 15).  It was worked
  62.   on at home usually between the hours of 10 and Midnight.
  63.   
  64. - Was O Boy entered into the MacHack contest? - June 20th 1996.
  65.  
  66. - Did I purchase my first Mac?
  67.   1984 - of course!  It was the same year I met my wife ...
  68.   needless to say it was a great year!
  69.   
  70. - Did I land my first Mac development job?  1994.
  71.  
  72. - Will the next version of O Boy be?
  73.   Who knows?  Suggestions are welcome.  
  74.  
  75. - You find a bug?
  76.   If you find a bug (aka defect) please let me know.  If you want to
  77.   use some O Boy code in a product of yours - help yourself but 
  78.   I ask that you send me a copy of that product - see where.
  79.  
  80.  
  81.  
  82.  
  83. Where
  84.  
  85. - Can I be reached?
  86.   If you would like to contact me via e-mail...
  87.         Home: rboylan@suffolk.lib.ny.us 
  88.         Work: MonHacker@aol.com
  89.   or US Mail
  90.         79 Saddle Rock Road
  91.         East Setauket, NY  11733
  92.  
  93. - Did I develop O Boy?
  94.   At home, Long Island New York.  If you really care, the room
  95.   is peach, the desk is brown, and the back door is within reach.
  96.   I used a Mac II fx that was loaned to me by my employer and, once
  97.   again if you care, the desktop pattern is that stock 
  98.   blue/green/black plaid.
  99.   
  100.  
  101.  
  102. Why
  103.  
  104. - Did I develop O Boy?
  105.   Because I was sick and tired of using script editor
  106.   to query objects.
  107.   
  108.   and also ...
  109.   
  110.   Because when I thought about developing a Hack for MacHack
  111.   nothing 'cool' was coming to mind - so I decided to do
  112.   something I needed instead.  Boring - I know, but hopefully
  113.   fellow MacHackers will take it back to work with them 
  114.   after the contest and really really really use it.
  115.   
  116.   
  117. - Did I use the Game Boy human interface?
  118.   Because it had the simple interface elements I needed to 
  119.   navigate the AEOM hierarchy.  It also has the feel of a 
  120.   Star Trek tri-corder.  Did you ever see how they just 
  121.   whip out that little thing and in a nanosecond they know
  122.   everything - that is the spirit of O Boy.
  123.   
  124. - Does the 'B' key get you to about O Boy dialog?
  125.   Because I couldn't think of any function for that key.
  126.   If you have any ideas ...let me know.
  127.  
  128.  
  129. How
  130. - Navigating the AEOM hierarchy
  131.   Use the + sign control to go up/down/left/right in the hierarchy
  132.   
  133.   double click a submodel to display it (go down hierarchy)
  134.   
  135.   command + left  brings you to the first of a kind
  136.   command + right brings you to the last of a kind
  137.   command + up    brings you to the top level
  138.   
  139.   option  + left  brings you 10 to the left
  140.   option  + right brings you 10 to the right
  141.   
  142.   
  143. - Update the current object data?
  144.   hit the 'a' key ... the circle on the right.
  145.   
  146. - Cancel an update?
  147.   hit command + .
  148.  
  149. - Did I develop O Boy?
  150.   With some crankin tools
  151.   - Metrowerks Codewarrior
  152.   - BBEdit
  153.   - The Jasik Debugger
  154.   - Resorcerer
  155.   - AEGizmos
  156.   - QC
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163. ------------------------------------------
  164. The Future
  165.  
  166. Looking into that crystal ball ... I see many ways to improve on O Boy - hopefully the time to do it is available too.  I will share with you some of the ideas I am entertaining and hope that you could do the same.  
  167.  
  168. 1 Property Boys.
  169.  
  170. O Boy does a decent job of depicting an object but it really needs to do a better
  171. job displaying properties.  How about ... when you double click on a property it
  172. launches an application (<property descriptor type> Boy, reverting to hex boy)
  173. and sends it an apple event like this: make new view with properties {data:_,
  174. propid:_, appaddr:_, objname:_).  Finding the app using the file manager is
  175. simple but would require that these property boys be in the same directory as O
  176. Boy.  It may be better to ask the finder, via apple events, to find it - that it
  177. what it does - right?
  178.  
  179. Anyway, these property boys could be written in something like PowerPlant.  The
  180. default app, hex boy, would be an app that contains TextEdit windows with hex
  181. data.  Just edit the hex data and hit the - 'send' button.  With that alone you,
  182. the programmer, would be able to avoid creating scripts for long periods of time.
  183.  Once one property boy was written it could be shared with other programmers and
  184. then the number of (good) custom boys could grow.  Creating a library of these
  185. property boys could be equivalent to filling your garage with power tools that
  186. would make Norm Abrams drool.  Just think of it, an RGB Boy, a Rectangle Boy, an
  187. Alias Boy, a Picture Boy ... why does this feel like OpenDoc?
  188.  
  189.  
  190. 2 Network Root.
  191.  
  192. Right now the O Boy hierarchy is rooted at 'this Macintosh' but it could be
  193. rooted at the network.  How about ... when you start it up you see the apps on
  194. this macintosh but can hit the "+" up direction and see all the Macs on the
  195. network, hit "+" again and see the zones.  Once up there, you would be able to go
  196. down the hierarchy into any Mac that has program linking on.  This could be the
  197. ultimate telescope into your neighbor's back yard.  You would be able look and
  198. see what documents your boss is editing - right now - sounds like power to me. 
  199. Anyway, I guess using the PPC browser would be the easiest way to get this going
  200. ... but I think it would feel better without it.  Now, if I could only get a
  201. network happening at home....
  202.  
  203.  
  204. 3 Test Point Objects.
  205.  
  206. We all have test/debug versions of our apps now - right?  Well, what if we went
  207. one step further and made test point objects that O Boy could tap into for
  208. information.  For PowerPlant apps I see a lazy LModelObject for providing
  209. LPane/LView information.  Right now this gap is filled with debuggers but with
  210. the right property boys (see #1 above) ... maybe it would be worthwhile.  I guess
  211. the idea here is really about helping the 'tester' of your app do more white box
  212. testing.  Remember, the spirit of O Boy is about the Star Trek Tri-corder ... so
  213. giving testers, or anyone else for that matter, that kind of diagnostic power is
  214. what it is all about.
  215.  
  216.  
  217. 4 Artwork
  218.  
  219. As you can see, I'm not the most artistic of programmers - maybe something more
  220. like artistically challenged.  If someone with that 'eye' for art wants to donate
  221. artwork (better buttons and the like) then please feel free to drop me a line. 
  222. The way it stands now - it's functional, and for me that's OK.
  223.  
  224.  
  225. The Past
  226.  
  227. Developing O Boy was enjoyable - it just took longer than it should (sound
  228. familiar?).  Most of the problem were creating the fictitious computer object. 
  229. Making it look as though the AEOM was rooted at the computer was not fun ... but
  230. once it was done and the objects were being viewed ... everything fell into
  231. place.  After that I really starting using it and you know something ... it
  232. really is a handy tool.
  233.  
  234.  
  235.  
  236.  
  237.  
  238. Notes at the Hack ... Added the ability to pump up the volume all the way to 11
  239.  
  240.  
  241.  
  242.  
  243.